标签扩展

建议开发者将自定义标签库请放置应用目录中,请勿放在框架系统目录内,以免使用Composer更新框架时导致自定义标签库的丢失

下面是一个Demo标签库的示例:

  1. php
  2. namespace app\common\taglib;
  3. use think\template\TagLib;
  4. class Demo extends TagLib{
  5. /**
  6. * 定义标签列表
  7. */
  8. protected $tags = [
  9. // 标签定义: attr 属性列表 close 是否闭合(0 或者1 默认1) alias 标签别名 level 嵌套层次
  10. 'close' => ['attr' => 'time,format', 'close' => 0], //闭合标签,默认为不闭合
  11. 'open' => ['attr' => 'name,type', 'close' => 1],
  12. ];
  13. /**
  14. * 这是一个闭合标签的简单演示
  15. */
  16. public function tagClose($tag)
  17. {
  18. $format = empty($tag['format']) ? 'Y-m-d H:i:s' : $tag['format'];
  19. $time = empty($tag['time']) ? time() : $tag['time'];
  20. $parse = ';
  21. $parse .= 'echo date("' . $format . '",' . $time . ');';
  22. $parse .= ' ?>';
  23. return $parse;
  24. }
  25. /**
  26. * 这是一个非闭合标签的简单演示
  27. */
  28. public function tagOpen($tag, $content)
  29. {
  30. $type = empty($tag['type']) ? 0 : 1; // 这个type目的是为了区分类型,一般来源是数据库
  31. $name = $tag['name']; // name是必填项,这里不做判断了
  32. $parse = 'php ';
  33. $parse .= '$test_arr=[[1,3,5,7,9],[2,4,6,8,10]];'; // 这里是模拟数据
  34. $parse .= '$__LIST__ = $test_arr[' . $type . '];';
  35. $parse .= ' ?>';
  36. $parse .= '{volist name="__LIST__" id="' . $name . '"}';
  37. $parse .= $content;
  38. $parse .= '{/volist}';
  39. return $parse;
  40. }
  41. }

这时候我们的控制器继承Controller,在配置参数中配置:

  1. 'template' => [
  2. // 模板引擎类型 支持 php think 支持扩展
  3. 'type' => 'Think',
  4. // 模板路径
  5. 'view_path' => '',
  6. // 模板后缀
  7. 'view_suffix' => '.html',
  8. // 预先加载的标签库
  9. 'taglib_pre_load' => 'app\common\taglib\Demo',
  10. ],

我们就可以在控制器中对模版赋值:

  1. $this->assign('demo_time',time());

在模版中调用我们已经预先加载的标签:

  1. 开放标签

  2. {demo:open time='$demo_time'/}

  3. 闭合标签

  4. {demo:close name='demo_name'}
  5. {$key}=>{$demo_name}
  6. {/demo:close}

  7. {demo:close name='demo_name' type='1'}
  8. {$key}=>{$demo_name}
  9. {/demo:close}